Apple II
Sample Code Notes
_____________________________________________________________________________
                                                  Developer Technical Support


#1:    Shell

Version:    1.0                                                September 1988

APW Components:    Shell.Aii                      30 Aug 88
                   Shell.Macros                   18 Aug 88
                   Shell                          30 Aug 88

MPW Components:    Shell.Aii                      10 Aug 88
                   Makefile                       08 Jul 88

Shell performs a minimal set of tasks fundamental to virtually any Apple IIGS 
desktop application, including displaying an empty desktop with a menu bar and 
basic recommended menu options and supporting About... and Quit menu items.
_____________________________________________________________________________

The 65816 assembly language source code in Shell.Aii demonstrates standard 
data constructs, how to load and start tools in correct sequence, how to code 
a main event loop, how to close in sequence, and how to quit an application.  
Error handling is included, as well as support for desk accessories.  (This is 
currently the only example with proper support for desk accessories with 
respect to enabling and disabling the Edit menu.)

Shell.Aii and Shell.Macros have been used as a foundation for several of the 
other Sample Code applications.  We hope the Shell source code proves useful 
as a basis for your Apple IIGS software as well.

Use APW 1.0 and Apple IIGS System Disk 3.2 or later to execute the Shell file 
included with the APW-compatible source code files.  To create a load file 
under APW, issue the following command:  ASML Shell.Aii Keep=Shell.

MPW IIGS users need MPW 2.02, MPW IIGS Tools 1.0, and any version of the MPW 
IIGS assembler.  The program name needed by the MPW Build menu's Build option 
is Shell.

